Summary
Displays a dropdown list with time values that can be selected by the user. The dropdown below is a typical example of this component as it might turn out to the user. Since there is a lot of time formats around it is possible to specify the time format to be displayed.
Category | AS Date |
Version | 1.0 |
Complies with Xhtml 1.0 / 1.1 rules | Yes |
Supported server programming languages | C# Visual Basic.NET |
Output content type | inline |
When to use
This component is typically used when there is a need to collect time information from the user. Often this component is used in a form in combination with the Date picker component. If you combine the values from these two components you can let the user enter a precise publish or archive date for a Content Studio document.
Programming interface
Parameters
- Identifier
- An unique name that will be used to identify the generated dropdown. This value will also be used as the id attribute of the control so this value must be unique within the page.
- Interval
- The interval in minutes between each selectable time value. This value can be between 1 and 1440.
- Formatting options
- ClassName
- An optional css class name to be applied to the generated dropdown.
- Attributes
- Optional attributes for the generated dropdown box, ex. onChange="onChangeDropDown();" This must be a valid attribute syntax or an error is generated
- Time formatting string
- A string to use to format the time value displayed in the drop down. However the actual submitted value is always in the international 24 hour format. The format strings must be according to the time formats defined in the .NET DateTimeFormatInfo class.
- Non time selection options
- Use non time alternative
- Forces the component to insert a non time alternative. This enables the user to select a blank time value.
- Non time text
- The text to be displayed in the non time alternative in the generated dropdown. This value is ignored if the "Use non time alternative" argument is false.
- Time selection behaviour
- Use a specific intitial time value
- If this parameter is set the component is initialize the component with a specific time rather than the current time.
- Initial hour
- Specifies the hour part of the specified time in the 24 hours format. This value can be between 0 and 23.
- Initial minute
- Specifies the minute part of the specific time. This value can be between 0 and 59.
- Initial selection behaviour
- Determines how the component determines the inital select value in relation to the init time.
Remarks